home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / database / convr601.zip / BRUCE601.DOC next >
Text File  |  1996-01-24  |  32KB  |  589 lines
  1. BRUCE601.DOC                         1                         Revised: 01/24/96
  2.  
  3. --------------------------------------------------------------------------------
  4.                               Contact information
  5.  
  6. For the following routines:  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  7. FILL, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE,  READINIT,  READMAKE-created  files,
  8. and TXTABLE:
  9.  
  10.                 Bruce Guthrie
  11.                 Wayne Software
  12.                 113 Sheffield St.
  13.                 Silver Spring, MD 20910
  14.  
  15.                 fax: (301) 588-8986
  16.                 e-mail: bguthrie@nmaa.org
  17.  
  18. For the following routines:  CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ,
  19. and READY:
  20.  
  21.                 Bruce Guthrie
  22.                 Room H-4885
  23.                 U.S. Dept of Commerce/ESA/STAT-USA
  24.                 Washington, DC 20230
  25.  
  26.                 fax: (202) 482-2164
  27.                 voice: (202) 482-3234
  28.  
  29.                 e-mail: bguthrie@doc.gov
  30.  
  31. Foreign users:  Please provide  an  Internet-reachable  e-mail  address  in  all
  32. correspondence if you have any hope of getting a reply!  Internet e-mail is  the
  33. preferred method of contact for all  other  users  as  well.   America  On-Line,
  34. CompuServe, and Prodigy all offer Internet e-mail access so get with it!
  35.  
  36. Since these programs are typically "freeware"  (with  the  exception  of  people
  37. trying to make money from them instead of me), they generate maybe $100/year  in
  38. revenue for me.  As such, my ability to afford  wonderful  customer  support  is
  39. somewhat restricted.   Please  do  not  leave  messages  saying  "Call  me  long
  40. distance".  Also, please be specific  about  what  problems  you  encounter  and
  41. include command-line inputs as well as any control  or  INI  files  that  you're
  42. using.
  43.  
  44. The "production" releases of these programs are posted  directly  by  me  (Bruce
  45. Guthrie, the author) on the Simtel ftp site at ftp.coast.net.  More  information
  46. about locations at this site is provided later.  People are encouraged to upload
  47. them to bulletin board systems but I do not upload them to BBS's myself.
  48.  
  49. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  50. to this software, whether express or implied, including without  limitation  any
  51. implied  warranties  of  merchantability,  fitness  for  a  particular  purpose,
  52. functionality, data integrity or protection.
  53.  
  54.  
  55. BRUCE601.DOC                         2                         Revised: 01/24/96
  56.  
  57. --------------------------------------------------------------------------------
  58.                                   Introduction
  59.  
  60. This documentation provides some overview information on a number  of  utilities
  61. that have been posted by Wayne Software.  All  programs  described  herein  were
  62. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  63. Others were written for the U.S. Department of Commerce.  All are free  for  use
  64. provided relevant documentation is kept with the programs, no changes  are  made
  65. to the programs or documentation, and  they  are  not  bundled  with  commercial
  66. programs or charged for separately.
  67.  
  68. CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ, and READY are excluded  from
  69. the commercial-packaging restriction.  These programs  are  owned  by  the  U.S.
  70. Department of Commerce and may be re-distributed without restriction.
  71.  
  72. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP,  DIRTOTAL,  FILL,
  73. FIXTEXT,  FORTUNE,  HTMSTRIP,  PAGINATE,  READINIT,  or  TXTABLE  in  commercial
  74. packages other than shareware/freeware collections must pay a  $50  registration
  75. fee to "Wayne Software" at the following address.   READMAKE-created  files  are
  76. also subject to this limitation.  I don't expect to make any  money  from  these
  77. utilities but I don't want others to sell them instead.
  78.  
  79. This collection of utilities were compiled using Microsoft's  Visual  BASIC  for
  80. DOS 1.0 compiler.  In each  case,  Thomas  G.  Hanlin  III's  excellent  PBClone
  81. routines,  release  2.3,  provided  additional  functionality.   Since  Tom  has
  82. announced that he will be dropping support for his  PBClone  routines  to  allow
  83. himself to spend time on a real life,  future  directions  for  my  routines  is
  84. uncertain.  The basic routines should be able to be maintained  indefinitely  as
  85. long as DOS continues to exist; we'll see.  I keep thinking  that  I  should  be
  86. doing Windows programming but it's hard to get psyched  up  for  that  when  you
  87. think of Windows as a computer virus.  (Don't even think of  asking  me  what  I
  88. think of Bloatus Notes please...)
  89.  
  90. Documentation provided in appropriate ZIP files:
  91.  * routine.DOC: Each utility is separately described in a like-named *.DOC file.
  92.  * FILE_ID.DIZ: Standard Description In Zip file.
  93.  * BRUCEymm.DOC: This file serves to summarize all  of  the  various  utilities.
  94.      The "ymm" indicates the release date in  year/month  format.   "601"  means
  95.      1996, first month (Jan 1996).
  96.  * BRUCEINI.DOC: Most of the routines have defaults that can  altered  by  using
  97.      initialization files (inifiles).   These  are  referenced  in  the  regular
  98.      documentation and further described here.  (One thing about *.INI files; if
  99.      you don't have one, it's in your interests to specify the "/-I"  parameter.
  100.      Otherwise, the program searches your entire DOS path looking for the file.)
  101.  * BRUCEHEX.DOC: Many of the routines allow you to enter  parameters  as  either
  102.      hexadecimal  or  decimal  strings.   This  is  referenced  in  the  regular
  103.      documentation and further described here.
  104.  
  105.      All program documentation was created  using  a  text  editor  (PE2).   The
  106.      PAGINATE command (see below) was  used  to  justify  the  text  and  create
  107.      titles, page breaks, and (where provided) indexes.
  108.  
  109. Beta  testers  and  suggestions  are  always   appreciated.    Contact   me   at
  110. bguthrie@nmaa.org  Note that all beta releases are done via e-mail  so  if  your
  111. gateway can't handle some pretty big mail attachments,  you  definitely  do  NOT
  112. want to be a beta tester for me!  Modifications that are not of  mainstream  use
  113. can be contracted for.
  114.  
  115.  
  116. BRUCE601.DOC                         3                         Revised: 01/24/96
  117.  
  118. --------------------------------------------------------------------------------
  119.                             The programs themselves
  120.  
  121. The utilities are uploaded with a ZIP name that includes the year and  month  of
  122. the release in a "ymm" format ("601" is the January 1996  version).   The  files
  123. are posted directly by the author to the Simtel archives  at  ftp.coast.net  and
  124. are available via anonymous ftp through that site.  (Web freaks can  access  the
  125. http://www.coast.net/SimTel site.) Users are encouraged to  post  the  files  on
  126. bulletin boards and such but, again, the  author  directly  posts  only  to  the
  127. Simtel archives.
  128.  
  129. If you're using a version of the programs that's more  than  a  year  old,  it's
  130. almost always the case that there's a newer version.  Please check  the  ftp  or
  131. Web site for an update.  If you can receive binary attachments,  contact  me  at
  132. bguthrie@nmaa.org for free updates.  Alternatively, send $10 made out to  "Wayne
  133. Software" to the Wayne Software address above and I'll send  you  everything  on
  134. diskette.  (If you need anything other than 3.5" high density, specify that  too
  135. please.)
  136.  
  137. The current version of each program  is  documented  below.   In  addition,  the
  138. Simtel subdirectory name, the Simtel one-line description, and the regular short
  139. file description (from the *.DIZ file) are provided for each of the programs.
  140.  
  141. This listing is current as of the January 1996 (601) release.
  142.  
  143. SimTel/msdos/arcutil/
  144. av509.zip       Archive view: Free ZIP etc directory viewer
  145.  
  146.    AV.EXE:  Archive directory viewer.  Presents list of files in  archive  (ZIP,
  147.    ARC, etc) and lets you sort as desired.  Also allows resetting  of  the  file
  148.    date based on the archive's contents.
  149.  
  150. SimTel/msdos/textutil/
  151. bfind511.zip    Boolean FIND command (BFIND BEGIN & END)
  152.  
  153.    BFIND.EXE:  Allows Boolean-type FIND requests.  For example,  find  any  line
  154.    with one string AND another one, or any line with one string OR another.
  155.  
  156. SimTel/msdos/textutil/
  157. chang510.zip    Change strings in text files
  158.  
  159.    CHANGE.EXE:  Processes change commands in files.  Files can be  of  any  size
  160.    and type (e.g.  binary or text) and are  processed  quickly.   Up  to  thirty
  161.    change commands can be processed in a single pass.  Also provides ability  to
  162.    remove trailing spaces from text files.
  163.  
  164. SimTel/msdos/spredsht/
  165. convr601.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  166.  
  167.    CONVERT.EXE:  Converts between data  formats:   FROM  dBase,  ASCII-delimited
  168.    (typically commas between fields and quotes around strings), and fixed  field
  169.    TO Lotus WKS, ASCII-delimited, dBase, and fixed field.
  170.  
  171.  
  172. BRUCE601.DOC                         4                         Revised: 01/24/96
  173.  
  174. SimTel/msdos/dirutil/
  175. cops601.zip     Copies files modified since given date
  176.  
  177.    COPSINCE.EXE:  Copies all files modified since a given date.  Primarily  used
  178.    for making sure you have a back-up of stuff and also to copy updated programs
  179.    to another place.  Lets you define your own groupings of files if desired.
  180.  
  181. SimTel/msdos/batutil/
  182. dates601.zip    Warns you in advance of birthdays etc
  183.  
  184.    DATES.EXE:  Program that warns you in advance when an event like a  birthday,
  185.    anniversary, or holiday is coming up.   The  idea  is  to  give  you  advance
  186.    warning so you can send a card or get out of town in time.
  187.  
  188. SimTel/msdos/dirutil/
  189. dirco601.zip    Updates files based on source directory
  190.  
  191.    DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds  ability
  192.    to delete extra files in the destination subdirectory, copy hidden and system
  193.    files, and prepare a report showing inconsistencies.  Is frequently  used  by
  194.    network administrators to update workstation files.
  195.  
  196. SimTel/msdos/dirutil/
  197. dirto510.zip    Directory lister and totaller
  198.  
  199.    DIRTOTAL.EXE:  Prepares  report  showing  files  in  subdirectory  or  drive.
  200.    Allows some restriction requests (show only files with date  greater  than  a
  201.    certain value).  Similar to Norton's FF and  Ray  Van  Tassle's  WIZ  command
  202.    (which is a great program but it doesn't work on network or CD-ROM discs)  in
  203.    some ways but presents a more formal report.  Also allows  you  to  look  for
  204.    duplicate file names and search by attributes or dates.
  205.  
  206. SimTel/msdos/diskutil/
  207. fill601.zip     Stuffs as many files as possible on disk
  208.  
  209.    FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  210.    biggest files first and skipping those that won't fit.  Also provides  option
  211.    of splitting large files up, creating a status report, and other features.
  212.  
  213. SimTel/msdos/dirutil/
  214. filup601.zip    Copy updated files based on a control list
  215.  
  216.    FILUPDAT.EXE:  Program which compares a selected list of files  in  a  source
  217.    path against those in another path and copies those that have  been  updated.
  218.    Similar to DOS' REPLACE command but works from a stored list of files and can
  219.    handle any number of directories.
  220.  
  221. SimTel/msdos/textutil/
  222. fixtx601.zip    Translate text file characters en masse
  223.  
  224.    FIXTEXT.EXE:  Program which applies  a  user-definable  character-translation
  225.    table to a text file.  Can allow you to convert graphics characters to  their
  226.    ASCII equivalents, lowercase letters to uppercase letter, etc.  Can  also  be
  227.    used to translate DOS text files to Mac or Unix text files  and  vice  versa.
  228.    Can also expand tabs, remove trailing spaces, and remove backspaces.
  229.  
  230.  
  231. BRUCE601.DOC                         5                         Revised: 01/24/96
  232.  
  233. SimTel/msdos/batutil/
  234. fortn510.zip    Fine-tunes DOS FOR command w/options
  235.  
  236.    FORTUNE.EXE:  A tuner-upper for the DOS FOR command.  Generates a batch  file
  237.    which does all those wildcard things you wished FOR could do  (like  "FORTUNE
  238.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets  you  do
  239.    all sorts of things including  distinguishing  file  name  roots  from  their
  240.    extensions as well as incrementing file names by specified values.
  241.  
  242. SimTel/msdos/textutil/
  243. htmst601.zip    Reprocesses HTML pages for humans to read
  244.  
  245.    HTMSTRIP.EXE:  Goes  through  downloaded  pages  from  the  Web  and  removes
  246.    embedded HTML commands.  Reflows paragraphs and tries to  make  it  basically
  247.    readable.
  248.  
  249. SimTel/msdos/textutil/
  250. isamf509.zip    Full-text searching help desk documents
  251.  
  252.    ISAMFIND.EXE and ISAMMAKE.EXE:  Programs that work in conjunction to  provide
  253.    full-text searching of text files.  This is useful for helpdesk  applications
  254.    and other functions where you want to  search  for  files  and  retrieve  the
  255.    "best" document that matches your search criteria.
  256.  
  257. SimTel/msdos/textutil/
  258. pagin601.zip    Paginates text (indexes, sorts, tables)
  259.  
  260.    PAGINATE.EXE:  Reformats text files with embedded formatting codes.   Handles
  261.    things like titles, footers, indexes, alignment,  justification,  multicolumn
  262.    listings,  etc.   Also  provides  support  for  embedding  tabular  data   in
  263.    ASCII-delimited or dBase formats which can be embedded and/or sorted in  your
  264.    reports.
  265.  
  266. SimTel/msdos/textutil/
  267. read601.zip     Free viewer, also make any text self-viewing
  268.  
  269.    READ.EXE, READY.EXE, READINIT.EXE,  and  READMAKE.EXE:   Text  file  browsing
  270.    utilities.  READ--Supports marking, copying text, reading Unix and  Mac  text
  271.    files, etc.  Handles with files of  16,000  lines  or  less  (approx  800,000
  272.    bytes). READY--truncates or wraps lines over  80  characters  in  length  but
  273.    handles files of an unlimited number of lines.  READMAKE--Takes an ASCII-text
  274.    file and makes it self-viewable (using a READ clone).
  275.  
  276. SimTel/msdos/textutil/
  277. txtab601.zip    Generates text tables
  278.  
  279.    TXTABLE.EXE:  Program to generate text tables.  Was originally designed as  a
  280.    way of converting WordPerfect tables to text.
  281.  
  282.  
  283. BRUCE601.DOC                         6                         Revised: 01/24/96
  284.  
  285. --------------------------------------------------------------------------------
  286.                                 Revision history
  287.  
  288. Detailed revision histories for the programs are only maintained  for  the  last
  289. three releases.  After that, you get the major revision summaries only  for  the
  290. next three releases or so.  In any  case,  if  your  version  of  any  of  these
  291. programs is more than a year old, your version is definitely obsolete.  Hop onto
  292. Simtel or e-mail me or something and get the new version!
  293.  
  294. -------------- (full detail; revisions made 1 to 3 months ago)
  295. Release 96/01:
  296.  
  297.   All routines:  There are advantages to a month of snow and vacations.  On  the
  298.   one hand, it gives you time to test out  things  and  consider  those  changes
  299.   you've been thinking about for so long.  It also gives you plenty of  time  to
  300.   hop on the Web and get new ideas and such.  As a result, some of this  month's
  301.   releases include some major changes and  enhancements.   There's  even  a  new
  302.   routine or two. On the other hand, the number of people available to  actually
  303.   test these changes drops considerably (especially when much of  the  goverment
  304.   was on furlough). Let's hope for the best!
  305.  
  306.   In the meantime, my Internet provider has actually got e-mail working  so  I'm
  307.   happy.  The bguthrie@nmaa.org address can be used for any of  these  routines.
  308.   I've only been using this site for a week or so but, again, I'm hoping for the
  309.   best!
  310.  
  311.   All routines:  I got bored  putting  the  same  sections  in  every  piece  of
  312.   documentation I write.  The section on INI files has been expanded  and  moved
  313.   into a separate file called BRUCEINI.DOC which is included in the  appropriate
  314.   ZIP files.  Also, for  the  routines  that  support  hexadecimal  and  decimal
  315.   equivalent strings, the  hexadecimal/decimal  table  has  been  moved  into  a
  316.   separate file called BRUCEHEX.DOC which is also included  in  the  appropriate
  317.   ZIP files. This doesn't reduce the size  of  the  ZIP  at  all  (increases  it
  318.   actually) but it should reduce space if you use more than one of my programs.
  319.  
  320.   All routines:  Finally dropped support for the CONFIGWS.EXE settings from  all
  321.   routines.
  322.  
  323.   CONVERT:  Added cell filters (only write out the record based on the value  of
  324.   one or more cells in the record).  This is especially useful with  files  like
  325.   the SimTel archive file listing (ftp.coast.net, subdirectory  SimTel/filedocs,
  326.   filename simindex.zip) since it allows you to, for  example,  only  get  those
  327.   files that were added since 951001.  (Remember, the field-definition file  for
  328.   this file is included in the  CONVERT  archive.)  Modified  program  to  allow
  329.   assignments to be made to created variables within a record.  Fixed a bug with
  330.   /GAP=n  specification  (didn't  work  unless   you   asked   for   an   OUTDEF
  331.   specification). Added the ability to read Unix or Mac  text  files.   Switched
  332.   default from /TO WKS to /TO FIXED.  [Replaces convr512.zip]
  333.  
  334.   COPSINCE:  Mostly documentation update.  Some of what was specified there  was
  335.   wrong and didn't  match  what  the  routine  could  do  now.   Parameters  are
  336.   described a bit better now.  [Replaces cops509.zip]
  337.  
  338.   DATES:  Added /?&H parameter.
  339.  
  340.   DIRCOMP:  Fixed a bug  with  /ALL  (didn't  copy  if  files  were  identical).
  341.   Changed the default to write no  report  ("/-F")  and  added  a  "/F"  option.
  342.   Reformatted the output to the screen quite a bit.  Fixed up colors again (some
  343.  
  344. BRUCE601.DOC                         7                         Revised: 01/24/96
  345.  
  346.   how, I deleted all of the code I added last time on this) and added  "/-COLOR"
  347.   option since I really  hate  white  on  blue  (sorry!).   Added  a  number  of
  348.   parameters that are the reverse of what's up there (e.g. /UPDATE and /-UPDATE)
  349.   so INI files would work better and the screen display would make  more  sense.
  350.   Changed file counters to double integer instead of single so you can use it on
  351.   systems with like 2 million files instead of just  15,000-ish.   (Don't  ask.)
  352.   [Replaces dirco512.zip]
  353.  
  354.   FILL:  Minor change to make /LAST apply to /SPLIT disks  as  well.   [Replaces
  355.   fill512.zip]
  356.  
  357.   FILUPDAT:  Added support for *.INI files.  Allowed ctlfile  to  be  passed  in
  358.   with /Cctlfile  parm  so  it  could  appear  in  the  *.INI  file.   [Replaces
  359.   filup510.zip]
  360.  
  361.   FIXTEXT:  Added a /BINARY option which lets you strip binary codes from things
  362.   like  native  WordPerfect  files.   If  anyone  comes   up   with   a   useful
  363.   character-translation table for this, please let me know!  Didn't  realize  it
  364.   during testing but "/TO CRLF" type requests had to be in  uppercase  to  work;
  365.   changed that.  Also added a queue that keeps track of which files have already
  366.   been processed so if you're using wildcards with /REPLACE, you won't  get  the
  367.   same file processed multiple times.  [Replaces fixtx512.zip]
  368.  
  369.   HTMSTRIP:  Decided  to  simplify  the  programming  considerably  by  removing
  370.   support for the PAGINATE  command.   All  parameters  that  were  specific  to
  371.   PAGINATE have been dropped.  Dropped support for  /-WRAP  option  (who'd  want
  372.   that anyway?). Made /WIDTH a synonym for  /LENGTH;  changed  documentation  to
  373.   make  /LENGTH  the  standard  wording.   Switched  default  to  /-SYMBOLS  and
  374.   /-WARNINGS.  More debugging in <PRE>...</PRE> blocks.  Now  handles  <DD>  and
  375.   <OPTION> HTML commands.  Changed the  way  the  warning  and  other  on-screen
  376.   messages were displayed; should be a bit clearer now.  Titles of pages are now
  377.   centered.  Allowed for &...; replacements using the more  relaxed  rules  that
  378.   seem prevalent today in Web pages (" " is the standard but both " " and
  379.   "&32;" are being used).   Added  a  few  replacements  that  I  couldn't  find
  380.   documented anywhere; where else are people getting these  from?   Tables  come
  381.   out better now but they're certainly not perfect.  Eventually,  HTMSTRIP  will
  382.   handle the HTML  3.0  tables  directly  and  the  TXTABLE  program  (which  is
  383.   introduced this time) is a first shot at figuring  out  how  to  handle  them.
  384.   (TXTABLE doesn't directly handle HTML documents but  there's  an  undocumented
  385.   /TEST parameter in HTMSTRIP which generates an output file that TXTABLE  reads
  386.   and another undocumented /HTML parameter in TXTABLE which processes them;  the
  387.   combination shows you how I might be handling them in the future.) I processed
  388.   over a thousand Web pages with this command in January alone; it's amazing how
  389.   many  variations  (and  errors)  there  are   in   these   things!   [Replaces
  390.   htmst512.zip]
  391.  
  392.   PAGINATE:  Coded to make WIDTH a synonym for LENGTH; changed documentation  to
  393.   make LENGTH the standard wording.  Added ERRORLEVEL return  codes.   [Replaces
  394.   pagin512.zip]
  395.  
  396.   READ, READMAKE:  Changed program so F3/F9 would find next  line  with  string,
  397.   not necessarily the next  occurence  of  the  string  itself.   Tabs  are  now
  398.   expanded  on  display.   This  causes  the  maximum  line  length   to   shift
  399.   periodically but that's life.  F3/F9 now work  consistently  when  you  change
  400.   documents with Ctrl-PgUp  and  Ctrl-PgDn.   Added  /?&H  parameter.  [Replaces
  401.   read509.zip]
  402.  
  403.   READINIT:  Fixed a bug with passing in parms into  the  routine.   Added  /?&H
  404.  
  405. BRUCE601.DOC                         8                         Revised: 01/24/96
  406.  
  407.   parameter. [part of read601.zip]
  408.  
  409.   READY:  Allowed the  program  to  handle  files  with  lines  of  132  or  255
  410.   characters. Added parameters /80, /132, and /255 to let you specify which  one
  411.   to use but otherwise the program reads the first 6000 bytes of  the  file  and
  412.   determines the maximum line length from there.  Results in a bigger  temporary
  413.   file of course. Added the  various  horizontal  scrolling  key  options--Right
  414.   Arrow, Left Arrow, Tab, Shift-Tab, Ctrl-Right, Ctrl-Left.  Modified  /INDENT=n
  415.   parameter to allow you to specify an indent string indicator with the  ability
  416.   to include decimal and hexadecimal codes.  Fixed  up  a  bug  with  /INDENT=0.
  417.   Allowed you to indent the first line  of  a  continued  line  instead  of  the
  418.   subsequent lines by passing  in  /INDENT=-n.   Added  /?&H  to  show  you  the
  419.   hexadecimal and decimal values.  Added  support  for  binary  files  including
  420.   native format word processing files; new options for this  include:   /BINARY,
  421.   /FILTER, /EOL=str.  This allows you to read something like  a  Microsoft  Word
  422.   for Windows document and write it out as a text file; requires a lot of manual
  423.   work to create something usuable from the result but it's something.   Default
  424.   switched to /WRAP.  Added /?&H parameter. [part of read601.zip]
  425.  
  426.   TXTABLE:  New program.  I'm not really sure what will become of this  program.
  427.   Originally, it was designed as a way of processing WordPerfect tables which no
  428.   one seems to be able to write out correctly when you do the TextOut  function.
  429.   I also figured it would help in terms of figuring out how to handle  HTML  3.0
  430.   tables in the HTMSTRIP command.  The  ZIP  includes  a  (hopefully  temporary)
  431.   program called XWPTABLE.EXE which retrieves cells from WordPerfect 5.1 for DOS
  432.   files and writes them out in a format that TXTABLE can read and process.  [New
  433.   program; replaces nothing]
  434.  
  435. Release 95/12:
  436.  
  437.   All routines:  This release is  dedicated  to  the  comic  strip  "Calvin  and
  438.   Hobbes" which is about to disappear from 2,400 newspapers  across  the  world.
  439.   I'm not alone in knowing that I'll miss that strip,  the  only  really  bright
  440.   spot in comics these days.  (Being a nerd, I also  enjoy  "Dilbert"  but  that
  441.   strip never brings out the wonder of life, just the basic horrors of the  work
  442.   place.) Now I'll never know the horrors that someone like Calvin will face  on
  443.   his first date.  (Can you imagine how he would  have  perceived  of  something
  444.   like a bra strap?) It was also nice to know someone who was socially less  fit
  445.   than I was even while his cohort was so damned suave.
  446.  
  447.   Some routines may not work with Windows95's new  directory  format.   I'm  not
  448.   crazy enough to have installed the 1.0 version of an  operating  system  so  I
  449.   don't know but you might keep it in mind.
  450.  
  451.   CONVERT:  Now allows you to read fixed-fixed files which contain  lines  which
  452.   do not end with CR/LF.  These are typical of files created on a  mainframe  or
  453.   copied from a tape.  The routine SPLITREC was  previously  included  with  the
  454.   routine to get around this but that's being dropped with  this  release.   Now
  455.   allow the input and output file types to be the same; useful if  you  want  to
  456.   just reformat some existing data.  New  parameters:  /SCAN=n  (allows  you  to
  457.   specify the number of records to scan for maximum field widths if /FROM  ASCII
  458.   and /-INDEF are specified) and /GAP=n (adds n-characters to each output  field
  459.   if /-INDEF and /TO FIXED are  specified  so  columns  will  be  spaced  out  a
  460.   little).  Added a field-definition  file  (SIMIBM.DEF)  for  the  SimTel  file
  461.   archives.  Cleaned up the output field-definition file a little.  Changed  the
  462.   field-definition file to make the decimal count and output length optional.
  463.  
  464.   DIRCOMP:  Now allow for up to 10 file exclusions.
  465.  
  466. BRUCE601.DOC                         9                         Revised: 01/24/96
  467.  
  468.  
  469.   FILL:  Added a message for "last disk of /MULTI set" if you're writing to  the
  470.   last of a multi-disk set.  Also /LAST and /-LAST option indicator  to  control
  471.   whether it shows up or not.
  472.  
  473.   FIXTEXT:  Added automatic detection of  input  text  format  (lines  end  with
  474.   CR/LF, CR alone, or LF alone).  Makes  the  program  ideal  for  automatically
  475.   converting all files in a given subdirectory from, say, Unix text files to DOS
  476.   text files. This became necessary as I started downloading more files from the
  477.   Web.  Dropped a number of parameters related to this:  /CRLF,  /CR,  and  /LF.
  478.   Fixed-length input files now require /n parameter instead of both  /-LINE  and
  479.   /WIDTH=n parameters.  Fixed-length output files now require  /TO  n  parameter
  480.   instead  of  both  /TO  -LINE  and  /WIDTH=n  parameters.   Dropped   /WIDTH=n
  481.   parameter.  Now allow the output files to be created in another  subdirectory,
  482.   allowing you to convert a whole bunch of files from something  one  place  and
  483.   create them to another subdirectory.  Changed default to be not to  produce  a
  484.   *.BAD file (/-F).
  485.  
  486.   HTMSTRIP:  Decided HTMSTRIP did a decent enough job handling  the  files  that
  487.   the second PAGINATE pass was no longer necessary so /-PAG (don't use PAGINATE)
  488.   is now the default.  Split HTMSTRIP out from the PAGINATE  ZIP  for  the  same
  489.   reason. Added parameters:  /SPACES, /-SPACES, /TAB=n,  /WARNINGS,  /-WARNINGS,
  490.   /RULE=string.  Added support for HTML pages with Centering,  whether  PAGINATE
  491.   is used or not.  Added ability to replace [Image], [Input],  and  [Link]  with
  492.   your own strings.  Lots of bug fixes.  Added lots of additional codes  in  the
  493.   HTMSTRIP.INI file as specified by Dave  Raggett's  HyperText  Markup  Language
  494.   Specification Version 3.0 draft  (03/28/95).   Lots  of  debugging  on  tables
  495.   including handling (in a way)  tables  embedded  in  tables.   Dropped  /FORCE
  496.   parameter.  Added automatic detection and skipping of GIF, JPEG, and BMP files
  497.   so you can process all the files in your cache subdirectory.
  498.  
  499.   PAGINATE:  New /Linitfile parameter (allows you to replace characters from the
  500.   input file when you write  out  the  file).   New  marker  commands:   -TITLE,
  501.   -FOOTER, -HEADER  (turn  off  existing  titles,  footers,  and  headers),  and
  502.   PAGEEJECT=string. Dropped HTML and -HTML market commands since HTMSTRIP should
  503.   really be  used  instead.   Removed  HTMSTRIP  from  the  ZIP  and  separately
  504.   distributing.  Fixed following bugs:  (1) reduced chance of blow up if totally
  505.   whacked ASCII-delimited files, (2) the RIGHT marker command didn't  work,  and
  506.   (3) fixed a bug which kept writing out  Alt-255  characters  for  things  like
  507.   bulleted items; they are now replaced by  regular  spaces  on  output.   Other
  508.   changes:  (1) Got tired of it automatically generating an extra page (complete
  509.   with title) if you just happened to write to the last  line  of  the  previous
  510.   page so made titles  conditional  on  actually  printing  something  afterward
  511.   (unless EJECT FRONT or EJECT BACK is specified).  (2) Am now providing a  file
  512.   PAGNOASC.INI which removes graphic and other possibly non-printable characters
  513.   on output (see /Linitfile parameter).  (3) The  program  now  removes  leading
  514.   spaces from input sections  in  which  "#  CENTER"  is  in  effect;  this  way
  515.   re-centering can be successfully done.
  516.  
  517. Release 95/11:
  518.  
  519.   BFIND:  Added /EMPTY and /-EMPTY options.  Switched it so  the  program  reads
  520.   the input files in binary mode which means it won't blow up on non-text  files
  521.   like it did before (although, admittedly, searching for  strings  in  non-text
  522.   files isn't really advised).  Switched the program so it would work  with  DOS
  523.   text files (lines end with CR/LF), Mac text files (lines end with CR), or Unix
  524.   text files (lines end with LF).  Recoded so the program automatically presumes
  525.   search for two strings is "AND" unless otherwise specified (so  "BFIND  SimTel
  526.  
  527. BRUCE601.DOC                         10                        Revised: 01/24/96
  528.  
  529.   Archives *.TXT" is the same thing as "BFIND SimTel AND Archives *.TXT").
  530.  
  531.   DATES:  Allowed "/C" to be used to designate the date input file names.   This
  532.   allows them  to  be  entered  in  an  *.INI  file.   Fixed  up  the  DATES.TXT
  533.   distribution file to correctly reflect formula for start and end  of  Daylight
  534.   Savings Time in the United States (and of course  released  the  version  just
  535.   after DST ended...).
  536.  
  537.   DIRCOMP:  Fixed a bug with the /-F option.
  538.  
  539.   FIXTEXT:  Added /Linitfile option.  More debugging.
  540.  
  541.   HTMSTRIP:  Added automatic wrapping based on the desired line  length  so  you
  542.   don't have to use PAGINATE.   Added  indication  of  input,  link,  and  image
  543.   regions as suggested by the HTMLCon program by Satore Township.  Also switched
  544.   to using a user-provided lookup file for the &xxx; HTML replacement  codes  as
  545.   suggested by that program.  Added several new  options  including  /Linitfile,
  546.   /WRAP, /-WRAP, /SYMBOLS, and  /-SYMBOLS.   Fixed  up  some  stuff  related  to
  547.   <PRE>/</PRE> blocks.
  548.  
  549.   READY:  Added /LOAD option.
  550.  
  551. -------------- (kind of terse; revisions made 4 to 6 months ago)
  552. Release 95/10:
  553.  
  554.   BFIND:  Added wildcard and @listfile support to program.
  555.  
  556.   CHANGE:  Added @listfile support to program.
  557.  
  558.   CONVERT:  Fixed a bug with writing to DBF files when you wanted  input  fields
  559.   dropped.
  560.  
  561.   FILUPDAT:  Added /ERROR and /-ERROR parameters.
  562.  
  563.   FIXTEXT:  Added wildcard and @listfile input file name support to program.
  564.  
  565.   HTMSTRIP:  New command.  Is included in the archive with the PAGINATE command.
  566.  
  567.   PAGINATE:   Added  support  for   wildcards   and   @listfile   specification.
  568.   Additional command line parms:  /EXT=.xxx, /PAUSE, and  /-PAUSE.   New  marker
  569.   commands:  SUM, BREAK, INDENTER=string, FLAG=string, and RULE=string.
  570.  
  571. Release 95/09:
  572.  
  573.   All  programs:   Switched  documentation  to  include   page   headers,   full
  574.   justification, etc using PAGINATE command.
  575.  
  576.   CHANGE:  Added wildcard specs for the input file.
  577.  
  578.   ISAMFIND/ISAMMAKE:  Lots of changes (parms added and dropped).  Added  support
  579.   for combining files to be processed into a single file.
  580.  
  581.   PAGINATE:  Added support for the output file name in titles, footers, etc.
  582.  
  583.   READ:  Fixed some problems with searching.
  584.  
  585.   READY:  Added line processing ranges.
  586.  
  587.  
  588. 
  589.